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ABSTRACT 


This  Software  Requirements  Specification  (SRS)  specifies  the  engineering  and 
qualification  requirements  for  the  Business  Graphics  CSCI  of  the  Mapping  and 
Graphic  Information  Capability  (MAGIC).  Furthermore,  this  specification  will 
be  used  as  the  basis  for  the  design  and  formal  testing  of  that  CSCI. 

The  SRS  is  divided  into  3  major  sections.  These  sections  cover  Engineering 
Requirements  (Section  3) .  Qualification  Requirements  (Section  4) ,  and 
Preparation  for  Delivery  (Section  5). 

This  specification  supersedes  both  the  Rational-generated  Software 
Requirements  Specification  (configuration  identifier  8734/89-SRS-BG-003)  and 
the  Interface  Requirements  Specification  (configuration  identifier 
8734/89-IRS-GIPSY-003)  for  the  Business  Graphics  CSCI  that  was  delivered  under 
Contract  Number  DCA100-89-C-0015  and  dated  13  September  1989. 
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SECTION  1.  SCOPE 


This  section  provides  an  introduction  to  the  specification.  The  following 
paragraphs  discuss  the  identification  of  the  Computer  Software  Configuration 
Item  (CSCI) ,  provide  an  overview  of  the  CSCI,  and  a  document  overview. 

1 . 1  Identification 

This  Software  Requirements  Specification  (SRS)  establishes  the  engineering  and 
qualification  requirements  for  the  Business  Graphics  CSCI  (CSCI-3). 

1 • 2  CSCI  Overview 

The  Business  Graphics  CSCI  enables  the  MAGIC  user  to  create  and  display 
reports.  Each  report  consists  of  data  selected  from  a  previously  identified 
MAGIC  internal  format  subset  of  a  database.  This  CSCI  gives  the  user  the 
flexibility  to  display  a  report  in  a  form  most  suited  to  the  user's  needs, 
varying  from  simple  formatted  reports  to  line  graphs  and  pie  charts.  The 
Wingz  Commercial  Off-The-Shelf  (COTS)  package  has  been  used  to  provide  the 
user  with  two  levels  of  support:  an  assisted  mode,  which  helps  the  user  in 
constructing  reports  and  graphs,  and  an  unassisted  mode  in  which  the  user  is 
simply  placed  within  the  Wingz  product  and  is  expected  to  know  what  is  needed 
to  use  that  package  effectively. 

1 ■ 3  Document  Overview 

This  SRS  specifies  the  requirements  allocated  to  the  Business  Graphics  CSCI 
and  enables  the  Government  to  assess  whether  or  not  the  completed  CSCI 
complies  with  those  requirements.  Upon  Government  approval  and 
authentication,  the  SRS  becomes  the  Allocated  Baseline  for  the  CSCI  and  is 
used  by  the  contractor  as  the  basis  for  development  and  formal  testing  of  the 
CSCI. 

As  such,  this  SRS  specifies  the  complete  list  of  requirements  (functional, 
interface,  performance,  qualification,  etc.)  for  the  Business  Graphics  CSCI. 

It  includes  requirements  for  programming  design,  adaptation,  quality  factors, 
and  traceability  of  the  CSCI,  as  well  as  delivery  preparation  and  ancillary 
notes,  such  as  references  and  terms  and  abbreviations . 
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SECTION  2.  APPLICABLE  DOCUMENTS 


This  section  specifies  the  applicable  reference  documents  that  have  been  used 
during  the  preparation  of  this  specification. 

2 . 1  Government  Documents 

The  following  documents  of  the  exact  issue  shown  form  a  part  of  this 
specification  to  the  extent  specified  herein.  In  the  event  of  conflict 
between  the  documents  referenced  herein  and  this  specification,  this 
specification  shall  be  considered  a  superseding  requirement. 

SPECIFICATIONS: 

DI-MCCR-80025A 

SDP  2-90 

<reference> 

<reference> 

STANDARDS : 

DOD- STD- 2167A  Defense  System  Software  Development 

DRAWINGS : 

None 

OTHER  PUBLICATIONS: 

PM  *-90  Documentation  Standards  and  Publications  Style  Manual 

TM  405-90  Software  Standards  and  Procedures  Manual  for  the  JNGG 

Graphics  Program 

Copies  of  the  specifications,  standards,  drawings,  and  publications  required 
by  suppliers  in  connection  with  specified  procurement  functions  should  be 
obtained  from  the  contracting  agency  or  as  directed  by  the  contracting 
officer . 

2 . 2  Non-Government  Documents 

The  following  documents  of  the  exact  issue  shown  form  a  part  of 

this  specification  to  the  extent  specified  herein.  In  the  event  of  conflict 


Software  Requirements  Specifications  Data  Item 
Description  (DID) 

Software  Development  Plan  (SDP)  for  the  Mapping  and 
Graphic  Information  Capability  System  (MAGIC) 

Functional  Description  for  the  Graphic  Information 
Presentation  System  (GIPSY) 

Software  Quality  Program  Plan  for  the  Mapping  and 
Graphic  Information  Capability  System  (MAGIC) 
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between  the  documents  referenced  herein  and  the  this  specification,  this 
specification  shall  be  considered  a  superseding  requirement. 

SPECIFICATIONS: 


None 
STANDARDS : 


ANSI  X3. 159-1989 

Programming  Language  C 

DRAWINGS : 

None 

OTHER  PUBLICATIONS: 

0-201-10174-2 

PostScript  Language  Reference  Manual 

<reference> 

Wingz  Commander  Class  Manual 

<reference> 

Wingz  HyperScript  Manual 

<reference> 

Wingz  HyperScript  Video  Seminar  Handbook 

<reference> 

Wingz  Navigator  Class  Manual 

<reference> 

Wingz  Reference  Manual 

<reference> 

Wingz  Tutorial 

<reference> 

Wingz  User  Guide 

Technical  society  and  technical  association  specifications  and  standards  are 
generally  available  for  reference  from  libraries.  They  are  also  distributed 
among  technical  groups  and  using  Federal  Agencies. 
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SECTION  3.  ENGINEERING  REQUIREMENTS 


This  section  specifies  the  engineering  requirements  necessary  to  ensure  proper 
development  of  the  Business  Graphics  CSCI .  All  requirements  included  in  this 
section  are  allocated  from  those  defined  in  appendix  C  of  the  Functional 
Description  (FD)  referenced  in  the  specifications  of  paragraph  2.1. 


CSCI  External  interface  Requirements 


The  Business  Graphics  CSCI  interfaces  with  the  C  Library  and  the  Internal 
Processing  CSCI.  The  following  subparagraphs  provide  a  general  description  of 
each  interface. 


3.1.1  Business  Graphics  to  C  Library  (INT- 3 . 001')  .  This  interface  establishes 
the  connection  between  the  C  Library  and  the  Business  Graphics  CSCI.  This 
interface  is  used  to  perform  standard  input/cutput  operations,  access  math 
library  functions,  •.se  memory  allocation  operations,  and  to  launch  the  Wingz 
COTS  package . 


This  interface  satisfies  the  following  functional  requirements: 

a.  Build  a  tabular  report  (C.l) 

b.  Display  a  tabular  report  (C.2) 

c.  Modify  a  tabular  report  (C.3) 

d.  Enhance  a  tabular  report  (C.4) 

e.  Save  a  tabular  report  (C.5) 

f.  Access  a  previously  saved  tabular  report  (C.6) 

g.  Build  a  new  report  (C.7) 

(1)  Assign  function  (C.7. a) 

(2)  Delete  function  (C.7.b) 

(3)  Rename  function  (C.7.c) 

(4)  Subset  function  (C.7.d) 

(5)  Change  function  (C.7.e) 

(6)  Define  function  (C.7.f) 

(7)  Add  function  (C.7.g) 

(8)  Input  function  (C.7.h) 
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(9)  Review  function  (C.7.i). 


h.  Create  and  display  graphic  reports  (C.8) 

(1)  Bar  graphs  (C.8. a) 

(2)  Histograms  (C.8.b) 

(3)  Point  graphs  (C.8 .c) 

(4)  Line  graphs  (C.8.d) 

(5)  Curve  graphs  (C.8.e) 

(6)  Step  graphs  (C.8.f) 

(7)  Gantt  charts  (C.8.g) 

(8)  Pie  charts  (C.8.h) . 

i.  Modify  a  graphic  report  (C.9) 

(1)  Limiting  rows,  columns,  sections,  categories  (C.9. a) 

(2)  Adding  report  totals  (C.9.b) 

(3)  Vector  sequencing  (C.9.c). 

j.  Display  the  classification  of  a  graphic  report  (C.10) 

(1)  Report  titles  (C.lO.a) 

(2)  Clear  classification  (C.lO.b). 

k.  Explode  the  wedges  in  a  pie  chart  (C.ll) 

l.  Stack  the  hers  in  a  bar  graph  (C.12) 

m.  Enhance  graphic  reports  with  symbols  and  text  (C.13) 

n.  Control  graph  features  including  size,  color,  shading,  and  style  of 
line  (C . 14) 

o.  Save  a  graphic  report  (C.15) 

p.  Save  plotted  output  (C.16) 

q.  Generate  a  metafile  in  standardized  format  (G.5) 

r.  Control  various  devices  such  as  terminals,  printers,  or  plotters  via 
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device  drivers  (G.7) 


s.  \llow  certain  globals  to  prevail  throughout  a  user  session  (G.10) 
»1)  Classification  markings  (G.lO.c) 

(7;  Report  titles  and  modifying  them  (G.lO.d). 

t.  Color  processing  (G.ll). 

3.1.2  Busincsr  C  jphic.s  to  Internal  Processing  (INT-3.002) .  This  interface 
is  used  by  the  Business  Graphics  CSCI  to  access  low-level  and  system-wide 
utilities  and  serv.ce?;  resident  in  the  Internal  Processing  CSCI  (e.g.,  path 
name  manipulation,  string  manipulation,  and  Unix  system  toolbox  routines). 

This  interface  satisfic  tne  foli-c-'ing  functional  requirements: 

a.  Save  a  tabular  repoi'  (C.1?) 

b.  Access  a  previously  saved  ir\  :lar  report  (C.6) 

c.  Save  a  graphic  report  (C.15) 

d.  Save  plotted  output  (C.16) 

e.  Perform  file  management  (G.l) 

f.  Control  input/output  operations  (G.2) 

g.  Request  operating  system  services  (G.8) 

h.  User  control  of  operating  environment  attributes  (G.12) 

i.  Identify  and  save  GIPSY'S  internal  data  structures  (G.14) 

(1)  FDT  (G.14. a) 

(2)  QDF  (G.14.b) 

(3)  QDT  (G.14.c) 

(4)  GDS  (G.  14.  e)  . 

3 . 2  CSCI  Capability  Requirements 

The  following  subparagraphs  identify  the  capability  requirements  that  the 
Business  Graphics  CSCI  shall  satisfy.  The  CSCI  operates  in  two  states- - 
assisted  or  unassisted- -which  refer  to  whether  or  not  a  fully- functional 
graphical  user  interface  (GUI)  is  being  used.  Each  state  also  possesses  two 
modes--local  and  remote.  A  correlation  of  the  CSCI's  capabilities  to  both 
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states  and  their  modes  is  depicted  in  table  3-1. 

3.2.1  Matrix  Creation  (CAP- 3, l).  This  capability  provides  the  means  for  the 
user  to  define,  specify,  or  otherwise  build  a  statistical  matrix  to  include 
rows,  columns,  categories,  and  sections;  the  data  population  of  the  matrix; 
and  those  characteristics  pertinent  to  the  data  stored  in  the  matrix  (e.g., 
classification,  line  types,  colors). 

The  capability  operates  in  both  states  (assisted  and  unassisted)  in  local  mode 
which  would  utilize  the  Wingz  COTS  package.  For  the  advanced  user,  the 
capability  is  also  available  in  the  remote  mode  of  the  unassisted  state  (on 
the  H6000  platform  using  GIPSY  via  xterm) . 

This  capability  satisfies  the  following  functional  requirements; 
a.  Build  a  tabular  report  (C.l) 


Build  a  new 

report  (C 

.7) 

(1) 

Assign 

function 

(C .  7 .  a) 

(2) 

Delete 

function 

(C.7.b) 

(3' 

Rename 

function 

(C.7.c) 

(4) 

Subset 

function 

(C .  7 .  d) 

(5) 

Change 

function 

(C . 7 . e) 

(6) 

Define 

function 

(C .  7  .  f ) 

(7) 

Add  function  (C.7.g) 

(8) 

Input  function  (C.7.h) 

(9) 

Review 

function 

(C.7. i) 

c.  Display  the  classification  of  a  graphic  report  in  report  titles 
(C.lO.a) 

d.  Control  graph  features  including  size,  color,  shading,  and  style  of 
line  (C . 14) . 

3.2.2  Matrix  Modification  (CAP-3.2).  This  capability  provides  the  means  for 
the  user  to  modify  and/or  enhance  the  statistical  matrix  created  by  Matrix 
Creation  (CAP-3.1).  The  modifications  and  enhancements  available  shall 
include  limiting  the  rows,  columns,  sections,  and  categories;  vector 
sequencing;  adding  report  totals;  changing  or  clearing  the  data 
classification;  adding  symbols  and  text;  and  modifying  matrix  features  (e.g., 
classification,  line  types,  colors). 
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Table  3-1.  Mapping  of  States/Modes  to  Capabilities 


STATE 

MODE 

CAP-  3 . 1 

CAP- 3 . 2 

CAP- 3 . 3 

CAP- 

ASSISTED 

LOCAL 

• 

• 

• 

REMOTE 

UNA55 1 STED 

LOCAL 

• 

• 

• 

REMOTE 

• 

• 

• 

The  capability  operates  in  both  states  (assisted  or  unassisted)  in  local  mode 
which  would  utilize  the  Wingz  COTS  package.  For  the  advanced  user,  the 
capability  is  also  available  in  the  remote  mode  of  the  unassisted  state  (on 
the  H6000  platform  using  GIPSY  via  xterm) . 

The  capability  satisfies  the  following  functional  requirements: 

a.  Modify  a  tabular  report  (C.3) 

b.  Enhance  a  tabular  report  (C.4) 

c.  Modify  a  graphic  report  (C.9) 

(1)  Limiting  rows,  columns,  sections,  categories  (C.9. a) 

(2)  Adding  report  totals  (C.9.b) 

(3)  Vector  sequencing  (C.9.c). 

d.  Display  the  classification  of  a  graphic  report  (C.10) 

(1)  Report  titles  (C.lO.a) 

(2)  Clear  classification  (C.lO.b). 

e.  Enhance  graphic  reports  with  symbols  and  text  (C.13) 

f.  Control  graph  features  including  size,  color,  shading,  and  style  of 
line  (C . 14) . 

3.2.3  Display  Processing  (CAP-3.3).  This  capability  provides  the  means  to 
create  and  display  both  columnar- type  reports  or  graphical  depictions  of  the 
statistical  matrix.  Additionally,  this  capability  shall  provide  the  ability 
to  permit  user  selection  of  a  number  of  display  options  (e.g.,  exploded  pie 
wedges  and  stacked  bar  graphs). 

The  capability  operates  in  both  states  (assisted  or  unassisted)  in  local  mode 
which  would  utilize  the  Wingz  COTS  package.  For  the  advanced  user,  the 
capability  is  also  available  in  the  remote  mode  of  the  unassisted  state  (on 
the  H6000  platform  using  GIPSY  via  xterm) . 

The  capability  satisfies  the  following  functional  requirements: 

a.  Display  a  tabular  report  (C.2) 

b.  Create  and  display  graphic  reports  (C.8) 

(1)  Bar  graphs  (C.8. a) 

(2)  Histograms  (C.8.b) 
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(3) 

Point  graphs  (C.8.c) 

(4) 

Line  graphs  (C.8.d) 

(5) 

Curve  graphs  (C.8.e) 

(6) 

Step  graphs  (C.8.f) 

(7) 

Gantt  charts  (C.8.g) 

(8) 

Pie  charts  (C.8.h). 

c.  Display  the  classification  of  a  graphic  report  in  report  titles 
(C.lO.a) 

d.  Explode  the  wedges  in  a  pie  chart  (C.ll) 

e.  Stack  the  bars  in  a  bar  graph  (C. 12). 

3.2.4  Control  Operations  (CAP-3.4).  This  capability  provides  the  means  to 
control  and  coordinate  operations  among  the  other  capabilities  as  well  as 
provide  access  to  lower-level  services  (e.g.,  saving  and  accessing  previously 
saved  matrices  and  reports). 

The  capability  operates  in  both  states  (assisted  or  unassisted)  in  local  mode 
which  would  utilize  the  Wingz  COTS  package.  For  the  advanced  user,  the 
capability  is  also  available  in  the  remote  mode  of  the  unassisted  state  (on 
the  H6000  platform  using  GIPSY  via  xterm) .  While  in  the  unassisted  state, 
however,  the  capability  has  very  limited  control  and  coordination  capability. 

The  capability  satisfies  the  following  functional  requirements: 

a.  Build  a  tabular  report  (C.l) 

b.  Save  a  tabular  report  (C.5) 

c.  Access  a  previously  saved  tabular  report  (C.6) 

d.  Control  graph  features  including  size,  color,  shading,  and  style  of 
line  (C.14) 

e.  Save  a  graphic  report  VC.15) 

f.  Save  plotted  output  (C.16). 

3 . 3  CSCI  Internal  Interfaces 

The  following  subparagraphs  provide  a  description  of  the  internal  interfaces 
of  the  Business  Graphics  CSCI. 
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3.3.1  Control  Operations  to  Matrix  Creation  (RIN- 3 . 0011 .  This  interface  is 
used  by  Control  Operations  (CAP-3.4)  to  provide  whatever  control  and 
coordination  functions  are  required  in  support  of  Matrix  Creation  (CAP-3.1). 
The  functions  provided  will  include  whatever  localized  user  interface  is 
needed  to  access  the  COTS -provided  services  or  file  selection  and  access 
functions  provided  to  open  previously  saved  reports  and  matrices. 

This  internal  interface  satisfies  the  following  functional  requirements: 

a.  Build  a  tabular  report  (C.l) 

b.  Save  a  tabular  report  (C.5) 

c.  Access  a  previously  saved  tabular  report  (C.6) 

d.  Build  a  new  report  (C.7) 

(1)  Assign  function  (C.7. a) 

(2)  Delete  function  (C.7.b) 

(3)  Rename  function  (C.7.c) 

(4)  Subset  function  (C.7.d) 

(5)  Change  function  (C.7.e) 

(6)  Define  function  (C.7.f) 

(7)  Add  function  (C.7.g) 

(8)  Input  function  (C.7.h) 

(9)  Review  function  (C.7.i). 

* 

e.  Display  the  classification  of  a  graphic  report  in  report  titles 
(C.lO.a) 

f.  Control  graph  features  including  size,  color,  shading,  and  style  of 
line  (C. 14) 

g.  Save  a  graphic  report  (C.15) 

h.  Save  plotted  output  (C.16). 

3.3.2  Control  Operations  to  Matrix  Modification  (RIN-3.002).  This  interface 
is  used  by  Control  Operations  (CAP-3.4)  to  provide  whatever  control  and 
coordination  functions  are  required  in  support  of  Matrix  Modification 
(CAP-3.2).  The  functions  provided  will  include  whatever  localized  user 
interface  is  needed  to  access  the  COTS -provided  services  or  file  selection  and 
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access  functions  provided  to  open  previously  saved  reports  and  matrices. 

This  internal  interface  satisfies  the  following  functional  requirements: 

a.  Build  a  tabular  report  (C.l) 

b.  Modify  a  tabular  report  (C.3) 

c.  Enhance  a  tabular  report  (C.4) 

d.  Save  a  tabular  report  (C.5) 

e.  Access  a  previously  saved  tabular  report  (C.6) 

f.  Modify  a  graphic  report  (C.9) 

(1)  Limiting  rows,  columns,  sections,  categories  (C.9. a) 

(2)  Adding  report  totals  (C.9.b) 

(3)  Vector  sequencing  (C.9.c). 

g.  Display  the  classification  of  a  graphic  report  (C.10) 

(1)  Report  titles  (C.lO.a) 

(2)  Clear  classification  (C.lO.b). 

h.  Enhance  graphic  reports  with  symbols  and  text  (C.13) 

i.  Control  graph  features  including  size,  color,  shading,  and  style  of 
line  (C.14) 

j.  Save  a  graphic  report  (C.15) 

k.  Save  plotted  output  (C.16). 

3.3.3  Control  Operations  to  Display  Processing  (RIN-3.003).  This  interface 
is  used  by  Control  Operations  (CAP- 3. 4)  to  provide  whatever  control  and 
coordination  functions  are  required  in  support  of  Display  Processing  (CAP- 
3.3).  The  functions  provided  will  include  whatever  localized  user  interface 
is  needed  to  access  the  COTS -provided  services  or  file  selection  and  access 
functions  provided  to  open  previously  saved  reports  and  matrices. 

This  internal  interface  satisfies  the  following  functional  requirements: 

a.  Build  a  tabular  report  (C.l) 

b.  Display  a  tabular  report  (C.2) 
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c.  Save  a  tabular  report  (C.5) 

d.  Access  a  previously  saved  tabular  report  (C.6) 

e.  Create  and  display  graphic  reports  (C.8) 

(1)  Bar  graphs  (C.8. a) 

(2)  Histograms  (C.8.b) 

(3)  Point  graphs  (C.8.c) 

(4)  Line  graphs  (C.8.d) 

(5)  Curve  graphs  (C.8.e) 

(6)  Step  graphs  (C.8.f) 

(7)  Gantt  charts  (C.8.g) 

(8)  Pie  charts  (C.8.h). 

f.  Display  the  classification  of  a  graphic  teport  in  report  titles 
(C. 10. a) 

g.  Explode  the  wedges  in  a  pie  chart  (C.ll) 

h.  Stack  the  bars  in  a  bar  graph  (C.12) 

i.  Control  graph  features  including  size,  color,  shading,  and  style  of 
line  (C . 14) 

j.  Save  a  graphic  report  (C.15) 

k.  Save  plotted  output  (C.16). 

3.4  CSCI  Data  Element  Requirements 

No  internal  or  external  data  elements  have  been  identified  for  this  CSCI. 

3 . 5  Adaptation  Requirements 

The  following  subparagraphs  specify  the  requirements  for  adapting  this  CSCI  to 
site-unique  conditions  and  to  changes  in  the  system  environment. 

3.5.1  Installation-Dependent  Data.  There  are  no  specific 
installation-dependent  data  requirements  needed  for  adapting  this  CSCI  to 
site-unique  conditions  or  to  changes  in  the  system  environment. 
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3.5.2  Operational  Parameters.  There  are  no  specific  operational  parameters 
needed  for  adapting  this  CSCI  to  site -unique  conditions  or  to  changes  in  the 
system  environment. 

3 . 6  Sizing  and  Timing  Requirements 

Sizing  requirements  pertinent  to  this  CSCI  are: 

a.  A  minimum  of  8  megabytes  (Mb)  of  Random  Access  Memory  (RAM)  shall  be 
required  to  execute  MAGIC. 

b.  A  minimum  of  2  Mb  of  free  disk  space  shall  be  required  to  execute 
MAGIC. 

c.  A  minimum  of  16  Mb  of  swap  space  shall  be  required  to  execute  MAGIC. 
Timing  requirements  pertinent  to  this  CSCI  are  two-fold: 

a.  MAGIC's  response  to  a  user's  mouse  click  or  a  keystroke  for  a  menu  or 
dialog  box  shall  be  within  a  5  second  timeframe. 

b.  If  the  user- input  choice  requires  MAGIC  to  interface  with  a  COTS 
package  (either  launching  or  processing) ,  system  response  shall  be 
within  a  5  second  timeframe.  In  other  words,  the  user  must  either 
receive  some  sort  of  acknowledgment  that  processing  is  going  on  or 
obtain  the  end  result  of  their  selection. 

3 . 7  Safety  Requirements 

This  CSCI  is  a  software  product  and  is  intended  for  use  in  an  office 
environment.  As  such,  there  are  no  applicable  requirements  regarding 
potential  hazards  to  personnel,  property,  and  the  physical  environment. 

3 . 8  Security  Requirements 

MAGIC  is  released  as  an  unclassified  system  and  all  system  files  released  with 
it  are  unclassified.  However,  MAGIC's  features  may  be  used  to  analyze  and 
present  classified  information  from  classified  databases.  Under  these 
circumstances ,  MAGIC  shall  provide  the  facilities  to  properly  label  the  screen 
images  and  the  hardcopy  reports,  but  it  is  and  will  remain  the  user's 
responsibility  to  safeguard  any  and  all  classified  information.  MAGIC  cannot 
grant  access  to  classified  databases  unless  the  user  has  permission  and  access 
to  those  files. 

Security  requirements  for  all  hardware  suites  and  configurations  capable  of 
executing  MAGIC  shall  remain  the  same  as  required  for  other  operational 
considerations  pertinent  and  applicable  to  that  equipment  and  environment. 
Furthermore,  the  safeguarding  of  privacy  act  information  also  remains  the 
user's  responsibility. 
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Additional  requirements  regarding  integrity  requirements  are  specified  in 
subparagraph  3.10.4  of  this  specification. 

3 . 9  Design  Constraints 

This  CSC1  will  be  developed  in  accordance  with  the  standards  identified  in  the 
Software  Standards  and  Procedures  Manual  (SSPM) .  MAGIC  has  very  few  design 
constraints  due  to  its  utilization  of  ANSI  C,  X  Windows,  and  OSF/Motif  in 
functional  processing: 

a.  Due  to  usage  of  the  Oracle  COTS  package  for  database  management 
processing,  MAGIC  is  constrained  to  those  data  types  and  parameters 
supported  by  Oracle's  SQL*Loader  package. 

b.  Specific  tables  stored  in  the  Oracle  database  (on  the  workstation)  as 
well  as  specific  data  files  resident  on  the  WWMCCS  host  are 
accessible  only  to  the  MAGIC  user  who  has  created  them  (or  to  one  who 
has  been  given  permissions  to  them  by  the  owner). 

c.  Usage  of  the  host-based  GIPSY  system  will  introduce  a  number  of 
limitations  that  do  not  apply  to  a  MAGIC  user  utilizing  workstation- 
based  data.  Specifically,  not  all  of  Oracle's  capabilities  supported 
by  MAGIC  in  local  mode  can  be  supported  by  MAGIC's  interface  to  GIPSY 
due  to  inherent  differences  between  the  two  systems  (Oracle  and 
GIPSY) .  The  user  must  be  at  least  somewhat  aware  of  GIPSY  concepts 
and  terminology  which  is  different  (e.g.,  File  Descriptor  Table  (FDT) 
and  Index  File)  and  not  all  functionality  can  be  supported  (e.g., 
very  limited  Oracle  GROUP  functionality) . 

d.  Usage  of  a  modem  for  host  access  will  have  definitive  impacts  related 
to  both  how  and  how  fast  MAGIC  can  access  the  host,  retrieve  the 
data,  and  make  it  available  to  the  MAGIC  user  on  the  workstation. 

Some  software  developed  for  the  modem  will  be  modem- specif ic  and  some 
will  be  inapplicable  when  MAGIC  is  transitioned  to  a  direct  host 
communications  connection.  The  processing  speed  by  which  MAGIC  users 
can  receive  response  from  the  host  and  obtain  their  data  is  directly 
linked  to  modem  speed  (currently  2400  baud)  and  access  availability 
(via  Defender) . 

e.  Target  workstation  hardware  and  operating  system  specifics  are  still 
changing  at  the  time  of  writing  this  SRS .  Since  a  prototype  is  being 
developed  on  a  Sun  Scalable  Processor  Architecture  (SPARC)  station 
and  the  target  is  presumed  to  be  the  Macintosh  Ilfx,  the  design  is 
limited  to  those  aspects  common  across  the  platforms  wherever 
possible . 

f.  The  utilization  of  the  Wingz  COTS  package  to  perform  nearly  all 
business  graphics-related  processing  introduces  several  design 
constraints.  Currently,  nearly  all  of  the  constraints  noted  below 
arise  from  the  fact  that  MAGIC  is  being  developed  on  the  Sun 
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SPARCstation  and  the  Wingz  version  (Version  1.0)  for  the  Sun  platform 
was  designed  for  execution  in  the  SunView  environment.  Since  MAGIC 
has  been  designed  for  the  X  Windows  environment,  a  method  was  found 
that  permits  the  execution  of  Wingz  under  the  Xll/NeWS  server  with 
the  following  design  constraints: 

(1)  The  "look  and  feel"  of  Wingz  is  not  consistent  with  MAGIC'S 
Motif -based  "look  and  feel." 

(2)  The  help  text  available  with  Wingz  (in  Version  1.0)  cannot  be 
modified. 

(3)  The  menu  bar  title  cannot  be  modified. 

(4)  The  proper  import  of  data  into  Wingz  can  be  guaranteed  only  by 
using  an  assisted  query. 

(5)  Curve  graphs,  Gantt  charts,  and  histograms  are  not  directly 
supported  by  Wingz 

(6)  Wingz  requires  a  PostScript-capable  printer  or  Hewlett-Packard 
Graphic  Language  (HPGL)  plotter  to  print. 

(7)  The  experimental  interface  to  the  Xll/NeWS  server  may  cause 
unpredictable  results. 

(8)  The  code  generated  to  support  both  the  Xll/NeWS  server  execution 
method  may  not  be  portable  to  other  environments. 

3 . 10  Software  Quality  Factors 

The  following  subparagraphs  specify  the  software  quality  factors  or  "fitness 
for  use"  characteristics  that  are  required  for  the  Business  Graphics  CSCI. 

They  are  divided  into  11  categories:  correctness,  reliability,  efficiency, 
integrity,  usability,  maintainability,  testability,  flexibility,  portability, 
reusability,  and  interoperability. 

3.10.1  Correctness  Requirements.  The  requirements  contained  in  this 
subparagraph  specify  the  extent  to  which  the  CSC I  is  expected  to  satisfy  its 
specifications  and  fulfill  the  user's  mission  objectives.  The  correctness 
requirements  are : 

a.  The  software  shall  be  traceable.  The  functionality  of  the  CSCI  must 
possess  a  clear  linkage  from  the  requirements  to  the  implementation 
with  respect  to  the  specific  development  and  operational  environment. 

b.  The  software  shall  be  consistent.  The  contractor  is  required  to 
provide  uniform  design  and  implementation  of  techniques  and  notation. 

c.  The  software  shall  be  complete.  The  functionality  of  the  CSCI  must 
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provide  a  full  implementation  of  the  functions  required. 

3.10.2  Reliability  Requirements.  The  requirements  contained  in  this 
subparagraph  specify  the  extent  to  which  the  CSCI  is  expected  to  perform  its 
intended  functions  with  required  precision.  The  reliability  requirements  are: 

a.  The  error  tolerance  of  the  software  shall  be  2  percent.  The  CSC I  is 
required  to  provide  continuity  of  operation  at  least  98  percent  of 
the  time. 

b.  The  software  shall  be  consistent.  The  contractor  is  required  to 
provide  uniform  design  and  implementation  of  techniques  and  notation. 

c.  The  software  shall  be  accurate.  The  software  must  provide  the  user's 
required  precision  in  calculations  and  outputs  within  the  limitations 
of  the  Oracle  and  Wingz  COTS  packages. 

d.  The  software  shall  be  simplistic.  The  functions  of  the  CSCI  must  oe 
implemented  in  a  most  understandable  manner  and  avoid  those 
coding/ implementation  practices  that  increase  complexity. 

3.10.3  Efficiency  Requirements.  The  requirements  contained  in  this 
subparagraph  specify  the  amount  of  computing  resources  and  code  required  by 
the  CSCI  to  perform  its  functions.  The  efficiency  requirements  are: 

a.  The  execution  efficiency  of  the  software  shall  be  in  accordance  with 
the  timing  requirements  of  paragraph  3.6. 

b.  The  storage  efficiency  of  the  software  shall  be  in  accordance  with 
the  sizing  requirements  of  paragraph  3.6. 

3.10.4  Integrity  Requirements.  The  requirements  contained  in  this 
subparagraph  specify  the  extent  to  which  access  to  the  CSCI's  software  or  data 
by  unauthorized  persons  should  be  controlled.  The  integrity  requirements  are: 

a.  The  CSCI  shall  be  access  controlled.  However,  due  to  the  nature  of 
MAGIC's  design,  access  control  functions  are  provided  by  the  Human 
Interface  CSCI  (refer  to  Volume  I  of  the  SRS). 

b.  The  software  shall  be  access  auditable.  Some  methodology  must  b» 
provided  for  an  audit  of  the  access  of  both  software  and  data. 

3.10.5  Usability  Requirements.  The  requirements  contained  in  this 
subparagraph  specify  the  effort  required  to  learn,  operate,  prepare,  input, 
and  interpret  the  output  of  this  CSCI.  The  usability  requirements  are: 

a.  Training  for  the  use  of  this  CSCI  shall  be  provided  as  required 
through  normal  User  Support  activities  which  include  functional 
demonstrations.  Formal  training  is  not  required  at  this  time  due  to 
the  requirements  for  user- friendliness  and  usability  satisfied  by  the 
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Human  Interface  CSCI  (refer  to  VcTume  I  of  this  SRS) . 

b.  The  software  shall  be  communicative  and  provide  useful  inputs  and 
outputs  which  can  be  assimilated  by  the  user.  Although  much  of  this 
requirement  will  be  met  by  the  functionality  of  the  Human  Interface 
CSCI  (refer  to  Volume  I  of  this  SRS) ,  the  software  of  this  CSCI  must 
also  be  communicative  wherever  appropriate. 

c.  The  software  shall  be  operable.  A  smooth  transition  from  current 
GTpSY  operations  as  well  as  initial  familiarizations  with  the  Unix- 
V  d  workstation  must  be  provided  wherever  appropriate. 

3.10.6  Maintainability  Requirements .  The  requirements  contained  in  this 
subparagraph  specify  the  effort  required  to  locate  and  fix  an  error  in  the 
operational  software.  The  maintainability  requirements  are: 

a.  The  software  shall  be  consistent.  The  contractor  is  required  to 
provide  uniform  design  and  implementation  of  techniques  and  notation 

b.  The  software  shall  be  simplistic.  The  functions  of  the  CSCI  must  be 
implemented  in  a  most  understandable  manner  and  avoid  those 
coding/ imple" "ltation  practices  that  increase  complexity. 

c.  The  software  shall  be  concise.  Functions  must  be  implemented  with  a 
minimum  amount  of  code. 

d.  The  software  shall  be  modular.  The  modularity  of  the  CSCI  shall  be 
designed  and  implemented  using  four  major  attributes: 

(a)  Cohesi/eness  refers  to  the  functional  strength  of  a  module,  or 
how  single-minded  a  module  is.  The  modules  shall  strive  for 
high  cohesion  (functional)  wherever  possible  although  mid-range 
cohesion  is  acceptable.  The  seven  types  of  module  cohesion  are 

(1)  Coincidental  cohesion  (WORST) 

(2)  Logical  cohesion 

(3)  Temporal  cohesion 

(4)  Procedural  cohesion 

(5)  Communicational  cohesion 

(6)  Informational  cohesion 

(7)  Functional  cohesion  (BEST). 

(b)  Coupling  refers  to  the  interdependence  of  modules  (i.e.,  how 
they  communicate  with  each  other) .  Of  the  six  types  of 
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coupling,  modules  shall  strive  to  employ  data  coupling  wherever 
possible.  The  types  of  module  coupling  are: 

(1)  Content  coupling  (WORST) 

(2)  Common  Coupling 

(3)  External  Coupling 

(4)  Control  Coupling 

(5)  Stamp  Coupling 

(6)  Data  Coupling  (BEST) . 

(c)  Complexity  refers  to  the  logical  or  control  flow  complexity  of 
any  given  module.  Modules  shall  be  designed  with  low  complexity 
since  they  will  be  easier  to  test  and  maintain: 

(1)  The  cyclomatic  complexity  of  a  module  shall  be  kept  within 
10  as  determined  by  McCabe's  Cyclomatic  Complexity  Metric. 

(2)  The  size  of  any  module  shall  be  no  more  than  200  lines  of 
executable  code . 

(d)  Structure  refers  to  whether  or  not  a  program  is  structured. 
Modules  shall  be  designed  in  a  structured  manner  to  enhance 
maintainability  as  determined  by  the  principles  of  essential 
complexity  and  program  "knots": 

(1)  The  essential  complexity  of  a  module  shall  be  1. 

(2)  Modules  shall  have  0  "knots."  Knots  are  those  places  in  a 
program  where  the  control  path  crosses  another. 

e.  The  software  shall  be  self-descriptive.  The  software  must  contain 
sufficient  comments  to  provide  explanation  of  the  implementation  of  a 
function. 

f.  The  software  shall  be  traceable.  The  functionality  of  the  CSCI  must 
possess  a  clear  linkage  from  the  requirements  to  the  implementation 
with  respect  to  the  specific  development  and  operational  environment. 

3.10.7  Testability  Requirements.  The  requirements  contained  in  this 
subparagraph  specify  the  effort  required  to  test  the  CSCI  to  ensure  that  it 
performs  its  intended  function.  The  testability  requirements  are: 

a.  The  software  shall  be  simplistic.  The  functions  of  the  CSCI  must  be 
implemented  in  a  most  understandable  manner  and  avoid  those 
coding/implementation  practices  that  increase  complexity. 


3-16 


b.  The  software  shall  be  modular.  The  CSCI  must  satisfy  the 
requirements  of  modularity  specified  in  subparagraph  3.10.6  above. 

c.  The  software  shall  support  instrumentation.  All  paths  must  be 
testable  and  all  input  parameters  must  be  boundary  testable  (as 
defined  in  the  SQPP) . 

d.  The  software  shall  be  self-descriptive.  The  software  must  contain 
sufficient  comments  to  provide  explanation  of  the  implementation  of  a 
function. 

3.10.8  Flexibility  Requirements.  The  requirements  contained  in  this 
subparagraph  specify  the  effort  required  to  modify  operational  software.  The 
flexibility  requirements  are: 

a.  The  software  shall  be  modular.  The  CSCI  must  satisfy  the 
requirements  of  modularity  specified  in  subparagraph  3.10.6  above. 

b.  The  software  shall  be  general.  The  software  should  not  have  input, 
processing,  and  output  functions  mixed  in  the  same  modules;  all 
constants  should  be  defined  only  once;  and  application  and  machine- 
dependent  functions  should  not  be  mixed  in  the  same  modules. 

c.  The  software  shall  be  expandable.  The  CSCI  must  perform  logical 
processing  independent  of  data  storage  specifications  (not  commit  all 
available  memory  capacity)  and  be  extensible  in  terms  of 
computational  functions. 

d.  The  software  shall  be  self-descriptive.  The  software  must  contain 
sufficient  comments  to  provide  explanation  of  the  implementation  of  a 
function. 

3.10.9  Portability  Requirements.  The  requirements  contained  in  this 
subparagraph  specify  the  effort  required  to  transfer  the  CSCI  from  one 
hardware  configuration  and/or  software  system  environment  to  another.  The 
portability  requirements  are: 

a.  The  software  shall  be  modular.  The  CSCI  must  satisfy  the 
requirements  of  modularity  specified  in  subparagraph  3.10.6  above. 

b.  The  software  shall  be  self-descriptive.  The  software  must  contain 
sufficient  comments  to  provide  explanation  of  the  implementation  of  a 
function. 

c.  The  software  shall  be  machine- independent.  The  ANSI  C  code  used 
should  be  independent  of  word  and  character  size  and  the  data 
representation  should  also  be  machine -independent.  Wherever 
possible,  modules  should  be  free  of  input/output  references. 

d.  The  software  shall  be  as  software  system- independent  as  possible. 
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The  CSCI  shall  utilize  only  a  common,  standard  subset  of  ANSI  C  and 
should  limit  dependence  on  software  system  utilities  and  software 
system  library  routines  wherever  possible.  If  at  all  possible,  there 
should  be  no  operating  system  references. 

3.10.10  Reusability  Requirements.  The  requirements  contained  in  this 
subparagraph  specify  the  extent  to  which  the  programs  of  the  CSCI  can  be  used 
in  other  applications  (related  to  the  packaging  and  scope  of  the  functions 
that  the  programs  perform).  The  reusability  requirements  are: 

a.  The  software  shall  be  general.  The  software  should  not  have  input, 
processing,  and  output  functions  mixed  in  the  same  modules;  all 
constants  should  be  defined  only  once;  and  application  and  machine- 
dependent  functions  should  not  be  mixed  in  the  same  modules . 

b.  The  software  shall  be  modular.  The  CSCI  must  satisfy  the 
requirements  of  modularity  specified  in  subparagraph  3.10.6  above. 

c.  The  software  shall  be  as  software  system- independent  as  possible. 

The  CSCI  shall  utilize  only  a  common,  standard  subset  of  ANSI  C  and 
should  limit  dependence  on  software  system  utilities  and  software 
system  library  routines  wherever  possible.  If  at  all  possible,  there 
should  be  no  operating  system  references. 

d.  The  software  shall  be  machine - independent .  The  ANSI  C  code  used 
should  be  independent  of  word  and  character  size  and  the  data 
representation  should  also  be  machine -independent.  Wherever 
possible,  modules  should  be  free  of  input/output  references. 

e.  The  software  shall  be  self-descriptive.  The  software  must  contain 
sufficient  comments  to  provide  explanation  of  the  implementation  of  a 
function. 

3.10.11  Interoperability  Requirements.  The  requirements  contained  in  this 
subparagraph  specify  the  effort  required  to  couple  this  MAGIC  CSCI  with 
another  system.  The  interoperability  requirements  are: 

a.  The  software  shall  be  modular.  The  CSCI  must  satisfy  the 
requirements  of  modularity  specified  in  subparagraph  3.10.6  above. 

b.  The  software  shall  utilize  communications  commonality  wherever 
appropriate.  It  is  recognized  that  this  requirement  will  be 
satisfied  primarily  by  the  Internal  Processing  CSCI  (refer  to  Volume 
VII  of  this  SRS) . 

c.  The  software  shall  utilize  data  commonality.  The  CSCI  should  use  a 
single  module  to  perform  any  data  translations  and  standard  data 
representations  should  be  used. 


3 . 11  Human  Performance /Human  Engineering  Requirements 


Issues  related  to  human  performance  and  human  engineering  concerns  have  been 
noted  and  discussed  previously  in  subparagraph  3.10.5  of  this  specification. 

Operational  issues  are  concerned  with  the  hardware  and  software  support 
environments  required  for  the  user.  A  brief  summation  of  the  user's 
operational  needs  would  include  the  following: 

a.  Access  to  a  Unix-based  color  graphics  workstation  that  has  the  Oracle 
Relational  Database  Management  System  (RDBMS)  installed  on  it. 

b.  Access  to  a  Unix-based  color  graphics  workstation  that  has  the  Wingz 
spreadsheet  package  (marketed  by  Informix,  Inc.)  installed  on  it. 

c.  Access  to  auxiliary  devices  such  as  dot  matrix  printers,  Postscript- 
capable  laser  printers,  floppy  disk  drives  (1.44  Mb),  external  tape 
backup  units,  and  external  mass  storage  devices. 

d.  Access  to  the  WWMCCS  host  via  xterm  on  the  workstation. 

Human  error  is  a  final  issue  related  to  human  engineering  requirements.  Once 
Business  Graphics  has  been  initiated,  errors  will  be  captured  and  handled  by 
this  CSCI's  error  handling  facilities.  Error  handling  will  be  provided  via 
the  Human  Interface  CSCI  (Volume  I  of  this  SRS) . 

3 . 12  Requirements  Traceability 

A  mapping  of  the  engineering  requirements  in  this  specification  to  the 
functional  requirements  applicable  to  this  CSCI  in  the  FD  is  provided  in  table 
3-2.  A  mapping  of  the  allocation  of  the  CSCI  requirements  from  the  FD  to  the 
engineering  requirements  in  this  specification  is  provided  as  table  3-3. 
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Table  3-2.  Mapping  of  Applicable  Requirements  to  the  FD  (Part  1  of  4) 
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Table  3-2.  Mapping  of  Applicable  Requirements  to  the  FD  (Part  2  of  4) 


3-21 


Table  3-2.  Mapping  of  Applicable  Requirements  to  the  FD  (Part  3  of  4) 


TIMING 


DESIGN 
CONSTRA I  NTS 


CORRECTNESS 


reliability 


MA I NTA I  NAB  I L I TY 


TESTABILITY 


PORTAB I L I TY 


REUSABILITY 
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Table  3-2.  Mapping  of  Applicable  Requirements  to  the  FD  (Part  4  of  4) 


Table  3-3.  Allocation  of  Applicable  FD  Requirements  to  the  SRS 

(Part  3  of  6) 


DESIGN 
CONST  ft*  I  NTS 


Table  3-3.  Allocation  of  Applicable  FD  Requirements  to  the  SRS 

(Part  4  of  6) 


Table  3-3.  Allocation  of  Applicable  FD  Requirements  to  the  SRS 

(Part  6  of  6) 
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SECTION  4.  QUALIFICATION  REQUIREMENTS 


This  section  specifies  the  qualification  methods  to  be  used  to  ensure  that  the 
CSCI  requirements  of  sections  3  and  5  have  been  satisfied. 

4 . 1  Qualification  Methods 

This  paragraph  discusses  the  qualification  methods  to  be  used  to  ensure  that 
all  requirements  of  the  Business  Graphics  CSCI  have  been  satisfied.  The 
methods  utilized  shall  satisfy  the  requirements  described  in  the  Software 
Quality  Program  Plan  (SQPP)  and  in  section  5  (Formal  Qualification  Testing)  of 
the  Software  Development  Plan  (SDP) .  The  specific  methods  to  be  utilized  are 
as  follows  and  a  qualification  cross-reference  table  appears  as  table  4-1: 

a.  Demonstration  -  the  use  of  stubs  and  drivers  to  permit  the  functional 
operation  of  specific  program  unit(s)  to  ensure  that  the  function  to 
be  performed  is  done  so  correctly. 

b.  Test  -  the  execution  of  specific  program  unit(s)  utilizing  test  data 
to  ensure  that  the  algorithmic  logic  performs  correctly,  in 
accordance  with  established  test  procedures. 

c.  Analysis  -  the  verification  and  interpretation  of  the  results 
obtained  from  the  various  methods  described  in  this  paragraph  whereby 
the  Quality  Assurance  (QA)  Manager  shall  analyze  the  accumulated 
results  to  ensure  that  quality  assurance  standards  are  maintained. 

d.  Inspection  -  the  visual  review  of  source  code  and  documentation  to 
ensure  that  both  coding  standards  and  documentation  guidelines  are 
followed. 

e.  Reviews  -  the  use  of  In-Process  Reviews  (IPRs),  Initial  Operational 
Capability  (IOC),  and  Final  Operational  Capability  (FOC)  reviews  to 
ensure  that  software  development  fulfills  the  defined  requirements. 

4 . 2  Special  Qualification  Requirements 

No  special  qualification  requirements  are  applicable  for  this  CSCI. 
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Table  4-1.  Qualification  Cross-Reference  Table 


REQU  1  REMENT 

CM 

SECTION  3 

QUAL 1 F 1  CATION 

NAME 

1  DENT  1  F  1 ER 

PARAGRAPH 

methods* 

LEVEU 

Matrix  Creation 

CAP- 3 . 1 

3.2.1 

A,  D, 

1  ,  R,  T 

1.2 

Matrix  Modification 

CAP- 3 . 2 

3.2.2 

A.D.  1 

,  R,  T 

1.2 

Display  Processing 

CAP- 3. 3 

3.2.3 

A.D,  1 

,  R„  T 

1,2 

Contro 1  Operat 1 ons 

CAP- 3 . A 

3.2.1 

A.D,  1 

y  R,  T 

1.2 

*  Qua l i f i cot  ion  Method 

A  -  Ana  lysis 
D  -  Demonstration 
1  -  Inspection 
R  -  Rev  i  ews 


*  Qua  I i f i cat i on  Leve I 

1  -  Conf igurat ion  Item 

2  -  System  Integration 

3  -  System  Installation 


T  -  Test 


SECTION  5.  PREPARATION  FOR  DELIVERY 


The  Business  Graphics  CSCI  (CSCI-3)  shall  consist  of  all  completed  FOCs 
integrated  into  an  operational  system  along  with  any  corrected  deficiencies. 
The  preparation  of  the  CSCI  for  delivery  shall  include,  but  not  be  limited  to, 
the  following  (on  a  Sun  workstation) : 

a.  Recompile  and  relink  all  source  code  and  create  object  and  executable 
files 

b.  Provide  necessary  documentation  to  support  the  CSCI 

c.  Provide  magnetic  media  (1.44  Mb  disks  or  1/4"  tapes)  copies  of  both 
source  code  and  executable  files  in  support  of  the  CSCI 

d.  Provide  a  list  of  all  known  deficiencies 

e.  Provide  a  listing  of  all  source  programs  involved  in  the  preparation 
of  the  CSCI. 

Documentation  to  be  delivered  with  the  CSCI  includes  the  Software  Development 
Folders  (SDFs)  for  the  CSCI  and  a  Version  Description  Document  (VDD) . 
Furthermore,  that  portion  of  a  Software  Release  Bulletin  (SRB)  appropriate  to 
the  CSCI  shall  also  be  produced  and  delivered. 

The  release  media  is  UNCLASSIFIED  and  shall  be  accompanied  by  a  delivery 
letter. 
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SECTION  6 .  NOTES 


This  section  contains  information  of  general  interest  that  aids  in 
understanding  this  specification.  Specifically,  document  references  to 
include  both  source  and  issue  date  are  provided  as  well  as  a  terms  and 
abbreviations  paragraph. 

6 . 1  Document  References 

The  following  references  were  used  in  the  preparation  of  this  specification: 

a.  Adobe  Systems  Incorporated,  PostScript  Language  Reference  Manual. 

ISBN  0-201-10174-2 ,  Addison-Wesley  Publishing  Company,  Reading,  MA, 
June  1990 

b.  American  National  Standards  Institute  (ANSI),  Programming  Language  C. 
ANSI  X3. 159-1989,  New  York,  NY,  16  December  1989 

c.  Department  of  Defense  (DOD) ,  Defense  System  Software  Development. 
Department  of  Defense  Standard,  DOD-STD-2167A,  Washington,  D.C. , 

29  February  1988 

d.  DOD,  Software  Requirements  Specification.  Data  Item  Description 
(DID),  DI-MCCR-80025A,  Washington,  D.C.,  29  February  1988 

e.  Informix  Software,  Wingz  Commander  Class  Manual.  Lenexa,  KS,  1989 

f.  Informix  Software,  Wingz  HvperScriPt  Manual.  Mountain  View,  CA,  Sun 
Microsystems,  1990 

g.  Informix  Software,  Wingz  HvperScriPt  Video  Seminar  Handbook.  Lenexa, 
KS ,  1989 

h.  Informix  Software,  Wingz  Navigator  Class  Manual.  Lenexa,  KS ,  1989 

i.  Informix  Software,  Wingz  Reference  Manual.  Mountain  Valley,  CA,  Sun 
Microsystems,  1990 

j.  Informix  Software,  Wingz  Tutorial.  Mountain  Valley,  CA,  Sun 
Microsystems,  1990 

k.  Informix  Software,  Wingz  User  Guide.  Mountain  Valley,  CA,  Sun 
Microsystems,  1990 

l.  Joint  Data  Systems  Support  Center  (JDSSC) ,  Documentation  Standards 
and  Publications  Style  Manual.  Procedures  Manual  (PM)  1-90, 
Washington,  D.C.,  1  August  1990 

m.  JDSSC,  Functional  Description  for  the  Graphic  Information 
Presentation  System  (GIPSY).  <reference>,  Washington,  D.C., 
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1  February  1988 


n.  JDSSC,  Software  Development  Plan  (SDP)  for  the  Mapping  and  Graphic 
Information  Capability  (MAGIC) .  SDP  2-90,  Washington,  D.C. , 

1  November  1990 

o.  JDSSC,  Software  Quality  Program  Plan  for  the  Mapping  and  Graphic 
Information  Capability  (MAGIC)  (Draft),  <reference>,  Washington, 

D.C. ,  23  July  1990 

p.  JDSSC,  Software  Standards  and  Procedures  Manual  for  the  JNGG  Graphics 
Program.  Technical  Memorandum  (TM)  405-90,  Washington,  D.C. , 

1  December  1990. 

6 . 2  Terms  and  Abbreviations 

The  following  terms,  abbreviations,  and  acronyms  specific  to  this  document  are 
listed  below: 

ADP  .  Automated  Data  Processing 

Allocated 

Baseline  .  The  initially  approved  documentation  describing  an  item's 

functional  and  interface  characteristics  that  are 
allocated  from  those  of  a  higher  level  Cl;  specified  by 
MIL-STD-480B 

ANSI  .  American  National  Standards  Institute 

AT&T  .  American  Telephone  and  Telegraph,  Incorporated 

C  .  The  C  programming  language  as  specified  by  ANSI  Standard 

X3. 159-1989 

CAP  .  Configuration  identifier  prefix  used  to  designate  a 

capability 

Cl  .  Configuration  Item 

COTS  .  Commercial  Off-The-Shelf 

CSCI  .  Computer  Software  Configuration  Item 

Cyclomatic 

Complexity  .  A  software  metric  that  provides  a  quantitative  measure  of 

the  logical  complexity  of  a  program. 

DI  .  Data  Item 

DID . Data  Item  Description 

DOD  .  Department  of  Defense 

DOD-STD  .  Department  of  Defense  Standard 

DTIC  .  Defense  Technical  Information  Center 

FD  . - .  Functional  Description  as  specified  by  DID  # 

DI-IPSC-80689  of  DOD-STD-7935A 

FOC  .  Final  Operational  Capability 

GIPSY  .  Graphic  Information  Presentation  System 

GUI  .  Graphical  User  Interface 

HPGL  .  Hewlett-Packard  Graphic  Language 

HyperScript  .  A  programming  language  for  manipulating  elements  of  Wingz 

worksheets 
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H6000  .  Honeywell  6080  mainframe  computer  standard  at  all  WWMCCS 

sites 

Informix  .  Creators  of  the  Wingz  software  package 

INT  .  Configuration  identifier  prefix  used  to  designate  an 

external  interface 

IOC  .  Initial  Operational  Capability 

IPR  .  In-Process  Review 

IPSC  .  Information  Processing  Standards  for  Computers 

IRS - - Interface  Requirements  Specification  as  specified  by  DID 

if  DI-MCCR-80026A  of  DOD-STD-2167A 

ISBN  .  International  Standard  Book  Number 

JDSSC  .  Joint  Data  Systems  Support  Center 

JN - - NMCS  ADP  Directorate 

JNG  .  General  Applications  Division 

JNGG  .  Information  Systems  Branch;  the  OPR  for  MAGIC  development 

JTSA-P  .  Administrative  Control  Branch;  Pentagon  Technical 

Resource  Center,  Room  MF612A 

MAGIC  .  Mapping  and  Graphic  Information  Capability 

Mb  .  Megabyte;  1,024,000  bytes  of  data 

MCCR  .  Mission- Critical  Computer  Resources 

MIT  .  Massachusetts  Institute  of  Technology 

Module  .  In  the  MAGIC  environment,  a  C  language  function 

NMCS  .  National  Military  Command  System 

OPR  .  Office  of  Primary  Responsibility 

OSF  .  Open  Software  Foundation 

PM  .  Procedures  Manual 

PostScript  .  A  general  purpose,  page-oriented  programming  language 

with  powerful  built-in  graphic  primitives  that  is 
marketed  by  Adobe  Systems  Incorporated 

QA  .  Quality  Assurance 

RAM  .  Random  Access  Memory 

Rational  .  The  R1000  Ada  language -based  development  platform 

manufactured  and  sold  by  Rational  Corporation 

RDBMS  .  Relational  Database  Management  System 

RIN  .  Configuration  identifier  prefix  used  to  designate  an 

internal  interface  requirement 
SDF . . . Software  Development  Folder 

SDP .  Software  Development  Plan  as  specified  in  DID  if 

DI-MCCR-80030A  of  DOD-STD-2167A 
SPARC  .  Scalable  Processor  Architecture 

SQL  .  Structured  Query  Language  as  defined  in  ANSI  X3. 135 -1986 

SQPP  .  Software  Quality  Program  Plan  as  specified  in  DID  if 

DI-QCIC-80572  of  DOD-STD-2168 
SRB  .  Software  Release  Bulletin 

SRS  .  Software  Requirements  Specification  as  specified  by  DID  if 

DI -MCCR- 80025A  of  DOD-STD-2167A 

SSPM  .  Software  Standards  and  Procedures  Manual  as  specified  by 

DID  #  DI -MCCR- 80011  of  DOD- STD- 2167 

TM  .  Technical  Memorandum  as  specified  by  JDSSC  PM  1-90 

TR  .  Technical  Report 
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Unix  .  A  multi-tasking  operating  system  from  AT&T  that  executes 

on  a  wide  variety  of  computer  platforms  from  micro  to 
mainframe 

VDD  .  Version  Description  Document  as  specified  by  DID  # 

DI-MCCR- 80013A  of  DOD-STD-2167A 

Wingz  - .  A  spreadsheet  program  which  has  its  own  programming 

language  (HyperScript),  drawing,  and  chart-making  tools 

WWMCCS  .  Worldwide  Military  Command  and  Control  System 

X  Windows  .  A  device -independent  and  network- transparent  windowing 

protocol  for  graphics  workstations  developed  at  MIT  and 
copyrighted  in  1984 

xterm  .  A  terminal  emulator  provided  with  the  X  Window  System 

which  emulates  either  the  Tektronix  4014  or  the  VT102 
terminal  type 
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